---
id: topBar-searchBar
title: SearchBar
sidebar_label: Layout
---

## `visible`

| Type   | Required | Platform | Description                                                                                                                                                    |
| ------ | -------- | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| boolean | No      | iOS | Determines if SearchBar is visible or not |

## `focus`

| Type   | Required | Platform | Description                                                                                                                                                    |
| ------ | -------- | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| boolean | No      | iOS | Auto focuses search bar |


## `hideOnScroll`

| Type                    | Required | Platform | Description                    |
| ----------------------- | -------- | -------- | ------------------------------ |
| boolean | No       | iOS | Hides the UISearchBar when scrolling. |

## `hideTopBarOnFocus`

| Type               | Required | Platform | Description                   |
| ------------------ | -------- | -------- | ----------------------------- |
| boolean | No      | iOS | Indicates whether the navigation bar should be hidden when searching. True by default. |

## `obscuresBackgroundDuringPresentation`

| Type                    | Required | Platform | Description                    |
| ----------------------- | -------- | -------- | ------------------------------ |
| boolean | No       | iOS | A Boolean indicating whether the underlying content is obscured during a search. |

## `backgroundColor`

| Type                    | Required | Platform | Description                    |
| ----------------------- | -------- | -------- | ------------------------------ |
| Color | No       | iOS | The background color of the UISearchBar's TextField. |

## `tintColor`

| Type                    | Required | Platform | Description                    |
| ----------------------- | -------- | -------- | ------------------------------ |
| Color | No       | iOS | The tint color of the UISearchBar. Affects text selection color, as well as "Cancel" button color. |

## `searchBarPlaceholder`

| Type                    | Required | Platform | Description                    |
| ----------------------- | -------- | -------- | ------------------------------ |
| string | No       | iOS | The placeholder value in the UISearchBar. |

## `cancelText`

| Type                    | Required | Platform | Description                                           |
| ----------------------- | -------- | -------- | ----------------------------------------------------- |
| string                  | No       | iOS      | The text value of "Cancel" button in the UISearchBar. |
